package com.nanhai.buddhist.college.module.collegebase.service.textbookinfo.type;

import java.util.*;
import javax.validation.*;

import com.nanhai.buddhist.college.module.collegebase.controller.admin.textbookinfo.type.vo.TextbookTypeCreateReqVO;
import com.nanhai.buddhist.college.module.collegebase.controller.admin.textbookinfo.type.vo.TextbookTypeExportReqVO;
import com.nanhai.buddhist.college.module.collegebase.controller.admin.textbookinfo.type.vo.TextbookTypePageReqVO;
import com.nanhai.buddhist.college.module.collegebase.controller.admin.textbookinfo.type.vo.TextbookTypeUpdateReqVO;
import com.nanhai.buddhist.college.module.collegebase.dal.dataobject.textbooktype.TextbookTypeDO;
import com.nanhai.buddhist.college.module.collegebase.controller.admin.textbookinfo.type.vo.*;
import com.nanhai.buddhist.college.framework.common.pojo.PageResult;

/**
 * 教材分类 Service 接口
 *
 * @author AKai
 */
public interface TextbookTypeService {

    /**
     * 创建教材分类
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    String createTextbookType(@Valid TextbookTypeCreateReqVO createReqVO);

    /**
     * 更新教材分类
     *
     * @param updateReqVO 更新信息
     */
    void updateTextbookType(@Valid TextbookTypeUpdateReqVO updateReqVO);

    /**
     * 删除教材分类
     *
     * @param id 编号
     */
    void deleteTextbookType(String id);

    /**
     * 获得教材分类
     *
     * @param id 编号
     * @return 教材分类
     */
    TextbookTypeDO getTextbookType(String id);

    /**
     * 获得教材分类列表
     *
     * @param ids 编号
     * @return 教材分类列表
     */
    List<TextbookTypeDO> getTextbookTypeList(Collection<String> ids);

    /**
     * 获得教材分类分页
     *
     * @param pageReqVO 分页查询
     * @return 教材分类分页
     */
    PageResult<TextbookTypeDO> getTextbookTypePage(TextbookTypePageReqVO pageReqVO);

    /**
     * 获得教材分类列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 教材分类列表
     */
    List<TextbookTypeDO> getTextbookTypeList(TextbookTypeExportReqVO exportReqVO);

    /**
     * 查询树结构
     * @return
     */
    List<TextbookTypeTreeRespVO1> getTextbookTypeTreeList();

    /**
     * 查询树状结构分页
     * @param pageVO
     * @return
     */
    PageResult<TextbookTypeTreeRespVO>  getTextbookTypeTreePage( TextbookTypePageReqVO pageVO);

}
